/* ===================

AX2E (AXESCON XACML 2.0 Engine) is the Java authorization engine, which implements OASIS XACML 2.0 standard.
Copyright (C) 2007 AXESCON LLC

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA


Contact: AXESCON LLC - info{at}axescon.com

 =================== */
package axescon.xacml.api;

import axescon.xacml.model.ctx.Result;
import axescon.xacml.model.ctx.XacmlCtx;
import axescon.xacml.model.ctx.Response;
import axescon.xacml.model.ctx.Request;
import axescon.xacml.model.policy.IdReference;
import axescon.xacml.model.policy.Policy;
import axescon.xacml.model.policy.PolicySet;
import axescon.xacml.engine.RuleEvaluator;
import axescon.xacml.api.alg.RuleCombAlgFactory;
import axescon.xacml.api.alg.PolicyCombAlgFactory;

/**
 * @author argyn
 * Date: Oct 20, 2005
 *         Responsibilities: evaluates policies and policy sets, as well as references to them
 */
public interface PolicyEvaluator {
    Result eval(Policy p, XacmlCtx req, CtxHandler ch) throws XacmlException;

    Result eval(PolicySet p, XacmlCtx req, CtxHandler ch);

    Result eval(IdReference idRef, XacmlCtx req, CtxHandler ch) throws XacmlException;

    Result evalMatched(Policy p, XacmlCtx req, CtxHandler ch) throws XacmlException;

    Result evalMatched(PolicySet p, XacmlCtx req, CtxHandler ch) throws XacmlException;

    void setDefaults() throws XacmlException;

    TargetMatcher getTargetMatcher();

    RuleEvaluator getRuleEvaluator();

    void setPolicyStore(PolicyStore policyStore);

    void setPolicyReferenceStore(PolicyReferenceStore policyReferenceStore);

    Response eval(Request req, CtxHandler ch) throws XacmlException;

    void validate(Policy policy) throws XacmlException;

    void validate(IdReference idRef) throws XacmlException;

    void validate(PolicySet policySet) throws XacmlException;

    void validate() throws XacmlException;

    RuleCombAlgFactory getRuleCombAlgFactory();

    PolicyCombAlgFactory getPolicyCombAlgFactory();
}
